home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / Text and Speech / BBEdit 2.2.2 / Installing BBEdit < prev    next >
Text File  |  1992-11-18  |  6KB  |  134 lines
  1. Installing BBEdit
  2. ---------- ------
  3.  
  4. This section explains how to install BBEdit in your system. It also explains in
  5. detail what files BBEdit creates, where they’re placed, and how to install
  6. optional parts of BBEdit.
  7.  
  8.  
  9. Basic Installation
  10. ----- ------------
  11.  
  12. BBEdit consists of the following major components:
  13.  
  14.  
  15. •    The BBEdit application itself
  16. •    The “BBEdit BBalloons” file
  17. •    The “BBEdit Extensions” folder
  18. •    MPW Shell tools and scripts required to support ToolServer
  19. •    The XTND system file and XTND translators
  20.  
  21.  
  22. When you expand the StuffIt archive which contains the BBEdit distribution, or
  23. insert your BBEdit floppy, you’ll see a window which contains the components
  24. of BBEdit.
  25.  
  26. Only the BBEdit application file is required to use BBEdit. All other components
  27. can be installed, or not, at your discretion. For example, if you’re putting
  28. together a minimal working disk for use on the road, you may not want the full
  29. suite of extensions, you may not need to use ToolServer, and you may have no
  30. requirement to import foreign file formats.
  31.  
  32. If you’re planning to install the whole set of BBEdit files, such as extensions
  33. and Balloon Help, create a “BBEdit Folder”. Copy the BBEdit application, the
  34. “BBEdit BBalloons” file (if you’re using System 7), and the “BBEdit Extensions”
  35. folder into your BBEdit Folder. When you’re done, your BBEdit Folder will look
  36. something like this:
  37.  
  38. Note: Balloon Help is not available in System 6, so there is no benefit derived
  39. from installing the “BBEdit BBalloons” file. You can save about 15K of disk
  40. space by not installing this file.
  41.  
  42. For BBEdit to use the installed extensions, the BBEdit Extensions folder must be
  43. in the same folder as BBEdit, as illustrated above.
  44.  
  45.  
  46. BBEdit Extensions
  47. ------ ----------
  48.  
  49. The “BBEdit Extensions” folder contains code modules which add additional
  50. functionality to BBEdit. Inside the “BBEdit Extensions” folder is a folder
  51. called “Sources”, and a file called “Writing BBEdit Extensions”. As shipped, the
  52. BBEdit Extensions folder occupies about 125K of disk space. If you’re not
  53. planning to use any extensions with BBEdit, you can save this space by deleting
  54. the BBEdit Extensions folder altogether. If you’re not planning to write
  55. extensions for BBEdit, you can save about 100K of disk space by removing these
  56. items from the BBEdit Extensions folder and deleting them from the disk
  57. containing your BBEdit folder.
  58.  
  59. ToolServer Support
  60. ---------- -------
  61.  
  62. If you’re planning to use BBEdit with ToolServer, first make sure that your MPW
  63. and ToolServer are correctly installed. As of this writing, ToolServer is only
  64. available as part of Apple’s ETO (“Essentials, Tools, and Objects”) CD-ROM
  65. subscription; the latest version of ToolServer is 1.0b3, found on ETO #8.
  66. APDA is on the verge of releasing ToolServer as a separate product, so
  67. for up-to-date information contact APDA: 1-800-282-2732.
  68.  
  69. Your BBEdit distribution includes a folder called “ToolServer Support”. This
  70. folder contains the following folders:
  71.  
  72. •    Copy to MPW folder: Drag the items in this folder into the same folder as
  73. your ToolServer application.
  74.  
  75.  
  76. •    Copy to MPW Tools folder: Drag the items in this folder into the “Tools”
  77. folder that’s in the same folder as the ToolServer application.
  78.  
  79.  
  80. •    Copy to MPW Scripts folder: Drag the items in this folder into the
  81. “Scripts” folder that’s in the same folder as the ToolServer application.
  82.  
  83.  
  84. Once you have dragged the items to the appropriate places in your ToolServer
  85. folder, delete the “ToolServer Support” folder.
  86.  
  87.  
  88. Claris XTND Support
  89. ------ ---- -------
  90.  
  91. If you will be using BBEdit to import and export word processor files, you need
  92. to install the contents of the “XTND Folder” that comes with BBEdit:
  93.  
  94. If you’re running System 7, drag the “Claris XTND System” file and the “Claris
  95. Translators” folder to the Extensions folder that is in your active system
  96. folder.
  97.  
  98.  If you’re running System 6, drag the “Claris XTND System” file and the “Claris
  99. Translators” folder to your active system folder.
  100.  
  101.  There is no need to restart your computer after installing the XTND support
  102. files.
  103.  
  104.  Note: If you already have an application installed which uses the Claris XTND
  105. translators and there’s already a “Claris Translators” folder in your System
  106. Folder or Extensions folder, then there’s no need to use the “Claris
  107. Translators” folder that comes with BBEdit.
  108.  
  109.  Warning: If you’re using System 7, make sure that there are no “alias loops” in
  110. your Extensions folder. An alias loop occurs when you have an alias in your
  111. Extensions folder that points to another folder (such as your Control Panels
  112. folder), and in that folder, you have an alias that points back to your
  113. Extensions folder, thereby creating loop. In these circumstances, the Claris
  114. XTND software will hang or crash your machine when you start up BBEdit.
  115.  
  116. BBEdit Files
  117.  
  118.  
  119. When you launch BBEdit for the first time on your system, it creates the
  120. following files:
  121.  
  122.  
  123. •    BBEdit 2.2 Prefs. This file contains settings and default preferences for
  124. various parts of BBEdit. This file resides in the appropriate place in your
  125. System Folder: if you’re using System 7, the file will be placed in the
  126. Preferences folder in your active System Folder; if you’re using System 6,
  127. BBEdit will look for a folder named “Preferences” in your active System Folder.
  128. If it finds a Preferences folder, the BBEdit Prefs file will be placed there;
  129. otherwise, the file will be placed in the System Folder itself.
  130.  
  131.  
  132. •    ToolServer Worksheet. The first time you use ToolServer with BBEdit, this
  133. file will be placed in the same location as the BBEdit Prefs file.
  134.